home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / utility / read707.zip / READINIT.DOC < prev    next >
Text File  |  1997-07-31  |  9KB  |  188 lines
  1. READINIT.DOC                           1                           Jul 31, 1997
  2.  
  3. The READINIT.EXE program creates and maintains a  file  called  READ.INI.   The
  4. READ.INI file is used to override certain defaults used by READ.EXE as well  as
  5. any self-viewing file created by READMAKE.EXE.
  6.  
  7. The specific defaults that can be changed:
  8.  
  9. *  Printer port:  Typically defaults to LPT1:  but can be redefined to  another
  10.    port or even a file name.
  11.  
  12. *  Printer string for regular text:  Allows you to specify the string that will
  13.    be sent to the printer port if text is printed and all lines in the document
  14.    are 80 characters or less in length.
  15.  
  16. *  Printer string for wide text:  Allows you to specify the string that will be
  17.    sent to the printer if text is printed and any lines  in  the  document  are
  18.    over 80 characters in length.
  19.  
  20. *  String after partial document printed:  Allows you to  specify  what  string
  21.    should be printed after a full document is printed.  This can include a page
  22.    eject character and/or printer reset information.
  23.  
  24. *  String after full document printed:   Allows  you  to  specify  what  string
  25.    should be printed after a full document is printed.  This can include a page
  26.    eject character and/or printer reset information.  Defaults to /012 which is
  27.    a page eject.
  28.  
  29. *  Color settings:  You can change the  four  color  sets  used  while  viewing
  30.    documents within the program.
  31.  
  32. The routine maintains a (short) list of printer brands and  some  of  the  more
  33. useful reset strings used for different modes.  (Ask for the HPLJ  settings  to
  34. get an idea.) This table can be expanded if people ask.  Contact Wayne Software
  35. at the address below; provide a  list  of  required  codes  for  all  desirable
  36. choices.  Be reasonable with the number of  choices.   In  any  case,  you  can
  37. always fill in any non-predefined codes that you want to.
  38.  
  39. READINIT  (and  READ)  look  for  the  initialization  file  in  your   default
  40. subdirectory first.  It then searches for it  in  the  subdirectory  where  the
  41. executable was and then goes through your DOS path.
  42.  
  43. The READ.INI file is further described in READ.DOC.  *.INI files in general are
  44. discussed in BRUCEINI.DOC.
  45.  
  46.  
  47. READINIT.DOC                           2                           Jul 31, 1997
  48.  
  49. Syntax:
  50.  
  51.     READINIT [ /PORT=port ] [ /PTYPE=name ] [ /INITT=string ] [ /INITW=string ]
  52.       [ /AFTERP=string ] [ /AFTERF=string ] [ /COLOR=nnn nnn nnn nnn ]
  53.       [ /MONO ] [ /Iinitfile | /-I ] [ /-ENV ] [ /? ] [ /?&H ]
  54.  
  55. where:
  56.  
  57. "/PORT=port" sets the default for READ, READY, and READMAKE-produced files.  It
  58. specifies the  printer  to  use  for  printing.   This  typically  defaults  to
  59. /PORT=LPT1:  although this can be overridden by the READ.INI file.
  60.  
  61. "/PTYPE=name" sets the default for READ, READY, and READMAKE-produced files. It
  62. specifies the name of the printer to use.  This allows you to  hook  into  some
  63. pre-defined  printer  settings  (contact  Wayne   Software   with   some   more
  64. initialization strings if you want some added).  Currently, the  only  accepted
  65. printers are HPLJ, EPSON, and OTHER.
  66.  
  67. "/INITT=string" ("initialize thin") sets  the  default  for  READ,  READY,  and
  68. READMAKE-produced files.  It provides the string  that  will  be  sent  to  the
  69. printer before printing if all lines in the document are 80 characters or  less
  70. in length.  The string can include regular characters.  Special characters  are
  71. entered by using  either  their  decimal  or  hexadecimal  representation  (see
  72. BRUCEHEX.DOC file).  "\027" is the code for the special character Escape.   You
  73. can specify /INITT=NULL if desired.  Defaults to "/INITT=NULL".
  74.  
  75. "/INITW=string" ("initialize wide") sets  the  default  for  READ,  READY,  and
  76. READMAKE-produced files.  It provides the string  that  will  be  sent  to  the
  77. printer before printing if any lines in the  document  (not  just  the  section
  78. printed) exceed 80 characters  in  length.   See  "/INITT=string"  description.
  79. Defaults to "/INITW=NULL".
  80.  
  81. For a Hewlett-Packard LaserJet, the following codes would typically be used:
  82.  
  83.         /INITT=\027E             (portrait mode, 80 column)
  84.         /INITW=\027E\027(s16.66H (portrait mode, 132 column)
  85.  
  86. "/AFTERP=string" sets the default for READ, READY, and READMAKE-produced files.
  87. It specifies the string to print after a partial  document  is  printed.   This
  88. string can include a page eject character ("\012") or any printer  reset  codes
  89. ("\012\027E") you want.  Initially defaults to "/AFTERP=\012".
  90.  
  91. "/AFTERF=string" sets the default for READ, READY, and READMAKE-produced files.
  92. It specifies the string to  print  after  a  full  document  is  printed.   See
  93. "/AFTERP=string" description.  Defaults to "/AFTERF=\012".
  94.  
  95.  
  96. READINIT.DOC                           3                           Jul 31, 1997
  97.  
  98. "/COLOR=nnn  nnn  nnn  nnn"   sets   the   default   for   READ,   READY,   and
  99. READMAKE-produced files.  It specifies the color settings to use for (in order)
  100. (1) regular text, (2) the status line, (3) marked text,  and  (4)  found  text.
  101. Each setting must consist of three digits, the first two being  the  foreground
  102. color and the last being the background color.  The foreground color should  be
  103. padded on the left with a 0 if it is only one digit in length.
  104.  
  105.   For /COLOR, default is /COLOR=150 151 157 143
  106.   For /MONO, default is  /COLOR=150 007 157 087
  107.  
  108. Foreground colors:
  109.  
  110.         Low intensity           High intensity
  111.  
  112.         0 = black                8 = dark grey
  113.         1 = blue                 9 = light blue
  114.         2 = green               10 = light green
  115.         3 = cyan                11 = light cyan
  116.         4 = red                 12 = light red
  117.         5 = magenta             13 = light magenta
  118.         6 = brown (or yellow)   14 = light yellow
  119.         7 = white               15 = bright white
  120.  
  121. Adding 16 to any color will make the text blink.  Background colors can consist
  122. of 0 to 7 above.  Bright white on blue, for example, would be "151".
  123.  
  124. "/MONO" (or "/-COLOR") sets READINIT to use standard monochrome  black,  white,
  125. and grey screen colors.  If a /COLOR=nnn nnn nnn nnn setting is  found  in  the
  126. INI  file,  /MONO  will  not  affect  the  default   colors   used   by   READ,
  127. READMAKE-produced files, or READY although, obviously, changing the colors used
  128. will be more limited if /MONO is used.  However, if no /COLOR=nnn nnn  nnn  nnn
  129. setting is found or /-I is passed in, /MONO will set the screen color  defaults
  130. as /COLOR=150 007 157 087.  Initially defaults to "/COLOR".
  131.  
  132. "/COLOR" (or "/-MONO") sets READINIT to use screen colors.  If a /COLOR=nnn nnn
  133. nnn nnn setting is found in the INI file, /COLOR will not  affect  the  default
  134. colors used by  READ,  READMAKE-produced  files,  or  READY.   However,  if  no
  135. /COLOR=nnn nnn nnn nnn setting is found or /-I is passed in,  /COLOR  will  set
  136. the screen color defaults as /COLOR=150 151 157 This is initially the default.
  137.  
  138. "/Iinitfile" says to read an initialization file with the file name "initfile".
  139. The file specification *must* contain a period.  Initfiles are described in the
  140. BRUCEINI.DOC file.  Initially defaults to "/IREAD.INI".
  141.  
  142. "/-I" (or "/INULL") says to skip loading the initialization file.
  143.  
  144. "/ENV" says to look for %var% occurrences  in  the  command  line  and  try  to
  145. resolve any apparent environmental variable references.  See  BRUCEINI.DOC  for
  146. more information.  This is initially the default.
  147.  
  148. "/-ENV" says to skip resolving apparent %var% occurrences in the command  line.
  149. Initially defaults to "/ENV".
  150.  
  151. "/?" or "/HELP" or "HELP" shows you the syntax for the command.
  152.  
  153. "/?&H" gives you a hexadecimal and decimal conversion table.
  154.  
  155.  
  156. READINIT.DOC                           4                           Jul 31, 1997
  157.  
  158. Author:
  159.  
  160. This program was written by Bruce Guthrie of Wayne Software.  It  is  free  for
  161. use and  redistribution  provided  relevant  documentation  is  kept  with  the
  162. program, no changes are made to the program or documentation,  and  it  is  not
  163. bundled with commercial programs or charged for separately.  People who need to
  164. bundle it in for-sale packages must  pay  a  $50  registration  fee  to  "Wayne
  165. Software" at the following address.
  166.  
  167. Additional information about this and other  Wayne  Software  programs  can  be
  168. found in the file BRUCE.DOC which should be included in the original ZIP  file.
  169. The recent change history for this and the other programs is  provided  in  the
  170. HISTORY.ymm file which should be in the same ZIP file where "y" is replaced  by
  171. the last digit of the year and "mm" is the two  digit  month  of  the  release;
  172. HISTORY.611 came out in November 1996.  This same naming convention is used  in
  173. naming the ZIP file (READymm.ZIP) that this program was included in.
  174.  
  175. Comments and suggestions can also be sent to:
  176.  
  177.                 Bruce Guthrie
  178.                 Wayne Software
  179.                 113 Sheffield St.
  180.                 Silver Spring, MD 20910
  181.  
  182.                 e-mail: WayneSof@erols.com   fax: (301) 588-8986
  183.                 http://www.geocities.com/SiliconValley/Lakes/2414
  184.  
  185. Please provide an Internet e-mail address on all correspondence.
  186.  
  187. 
  188.